Objetivo
Quando um CFOP é configurado incorretamente e diversos cupons fiscais já foram emitidos com essa informação, é possível realizar a correção em massa diretamente no banco de dados, evitando a atualização manual de cada registro.
Correção padrão
A forma convencional de corrigir o CFOP consiste em:
-
Alterar o CFOP no cadastro do produto no Gestores Retaguarda;
-
Executar a Replicação de Dados pelo SincData;
-
No GestorPDV, utilizar a opção:
Atualizar e Recalcular Tributação dos Itens da Venda
Esse procedimento é indicado para corrigir vendas individualmente.
Correção em massa

Quando for necessário corrigir diversos cupons fiscais simultaneamente, como em casos de alteração de CFOP, é possível utilizar scripts SQL para atualizar os registros diretamente no banco de dados.
Esse procedimento permite:
-
Corrigir o CFOP de vários itens de uma única vez;
-
Atualizar os cupons já gravados;
-
Garantir que as informações corretas sejam enviadas ao Gestores Retaguarda.
Importante: Antes de executar qualquer script diretamente no banco de dados, realize um backup completo da base. A execução deve ser feita apenas por profissionais autorizados e com conhecimento em PostgreSQL.
Script 1 — Atualizar o CFOP dos itens
Substitua os valores conforme a necessidade:
-
5656 → CFOP correto;
-
5405 → CFOP incorreto;
-
2 → GTIN (quando aplicável).
UPDATE ecf_venda_detalhe vi
SET cfop = '5656' -- CFOP correto
FROM ecf_venda_cabecalho v
WHERE v.id = vi.id_ecf_venda_cabecalho
AND vi.cfop = '5405' -- CFOP incorreto
AND vi.gtin = '2';
Esse script atualiza o CFOP dos itens que atendem aos critérios informados.
Script 2 — Marcar os cupons para atualização
Após corrigir os itens, execute o script abaixo para marcar os cabeçalhos das vendas como não atualizados, permitindo que sejam reenviados corretamente ao Retaguarda.
UPDATE ecf_venda_cabecalho v
SET atualizado = 'N'
WHERE EXISTS (
SELECT 1
FROM ecf_venda_detalhe vi
WHERE vi.id_ecf_venda_cabecalho = v.id
AND vi.cfop = '5656'
AND vi.gtin = '2'
);
O que esse procedimento faz?
Após a execução dos scripts:
-
Atualiza o CFOP dos itens selecionados;
-
Marca os cupons para nova sincronização;
-
Permite que o GestorPDV envie as informações corrigidas ao Gestores Retaguarda.
Resultado esperado
Após executar os scripts e sincronizar os dados:
-
Os cupons fiscais passarão a conter o CFOP correto;
-
As vendas serão reenviadas ao Retaguarda com a tributação atualizada;
-
As informações fiscais permanecerão consistentes entre o PDV e o Gestores.
Importante
Antes de executar os scripts, confirme:
-
Qual é o CFOP incorreto e o CFOP correto;
-
Se o filtro por GTIN deve ser mantido ou ajustado;
-
Se existe um backup recente da base de dados;
-
Se a correção será aplicada apenas às vendas desejadas, evitando alterações indevidas em outros registros.